Skip to content

Improve wording#114

Draft
sergi0g wants to merge 7 commits into
mainfrom
sergi0g/improve-wording
Draft

Improve wording#114
sergi0g wants to merge 7 commits into
mainfrom
sergi0g/improve-wording

Conversation

@sergi0g

@sergi0g sergi0g commented Apr 28, 2026

Copy link
Copy Markdown
Collaborator

Reword docs pages for clarity and a better user experience.

Summary by CodeRabbit

  • Documentation
    • Reorganized guide structure for improved navigation and clarity
    • Enhanced HTTPS with Let's Encrypt guide with clearer instructions and examples
    • Updated guide titles for better specificity in backup and maintenance sections
    • Expanded uninstall guide with backup recommendations and feedback encouragement

@vercel

vercel Bot commented Apr 28, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
runtipi-docs-staging Ready Ready Preview, Comment Apr 29, 2026 4:59am

@sergi0g sergi0g marked this pull request as draft April 28, 2026 15:45
@sergi0g sergi0g changed the title Update overview.mdx Improve wording Apr 28, 2026
@coderabbitai

coderabbitai Bot commented Apr 28, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: f24c4027-5a11-4018-9096-0bb2790309a9

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Walkthrough

This PR reorganizes documentation structure and content across multiple guide files. Changes include restructuring section separators in metadata from descriptive to uppercase keys, relocating the uninstalling guide to the "Backup & Maintenance" section, retargeting the DNS challenge guide to emphasize HTTPS/Let's Encrypt, updating guide titles for clarity, and expanding content with backup recommendations.

Changes

Cohort / File(s) Summary
Documentation Metadata & Structure
src/content/docs/guides/_meta.ts
Reorganized separators from descriptive keys ("###", "--- Customization", etc.) to uppercase keys ("NETWORKING", "CUSTOMIZATION", "BACKUP & MAINTENANCE", "ADVANCED"). Relocated uninstalling entry before the "ADVANCED" section and removed its later occurrence.
DNS Challenge Guide
src/content/docs/guides/dns-challenge-cloudflare.mdx
Reframed guide title and content from DNS challenge focus to HTTPS/Let's Encrypt emphasis while retaining Cloudflare as the example. Updated requirements, configuration paths, Traefik settings, testing guidance, and added support section with community links.
Guide Overview Page
src/content/docs/guides/overview.mdx
Updated card titles for backup and update guides with more specific wording. Relocated "Uninstalling Runtipi" card from "Advanced" to "Backup & maintenance" section.
Uninstalling Guide
src/content/docs/guides/uninstalling.mdx
Expanded introduction with advice to back up the runtipi folder before removal and encourage feedback sharing. Preserved original uninstall command sequence.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • Refactor/revamp #107: Modifies the same documentation files (_meta.ts, dns-challenge-cloudflare.mdx, overview.mdx, uninstalling.mdx) to reorganize guide metadata and content.

Suggested labels

size/M

Suggested reviewers

  • nicotsx
  • steveiliop56

Poem

🐰 Hop, hop, the docs take flight,
Sections reorganized, metadata tight,
HTTPS shines where DNS once gleamed,
Backup advice and guides resteemed,
Clean structure, clear paths, organized right!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'Improve wording' is too vague and generic; it describes what was changed in style but not which specific guides or what key improvements were made. Use a more descriptive title that identifies the specific documentation focus, such as 'Improve guide clarity: reorganize structure and reword DNS/uninstall guides' or similar.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch sergi0g/improve-wording

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (2)
src/content/docs/guides/dns-challenge-cloudflare.mdx (1)

59-62: Use “API token” consistently in this section.

The step creates a Cloudflare token, but the text starts with “API key,” which can be confused with Cloudflare’s separate Global API Key.

Proposed wording tweak
-Now we need to get the Cloudflare API key that Traefik is going to use in order to add the DNS records required for verification.
+Now we need to get a Cloudflare API token that Traefik will use to add the DNS records required for verification.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/content/docs/guides/dns-challenge-cloudflare.mdx` around lines 59 - 62,
Replace the inconsistent phrase "API key" with "API token" throughout this
section so it consistently refers to Cloudflare's API token (not the Global API
Key); specifically update the sentence that begins "Now we need to get the
Cloudflare API key..." to use "API token" and ensure any subsequent mentions
(e.g., "Create token", "save that token") match the same wording and emphasize
that the token is only shown once.
src/content/docs/guides/uninstalling.mdx (1)

15-15: Consider a more neutral closing tone.

This line reads a bit informal for a technical guide; a neutral close may age better across docs pages.

Suggested wording
-That's it! Go try something else out and have fun!
+That's it. Your Runtipi installation has been removed.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/content/docs/guides/uninstalling.mdx` at line 15, Replace the informal
closing sentence "That's it! Go try something else out and have fun!" with a
more neutral closing; locate the exact string in
src/content/docs/guides/uninstalling.mdx and swap it for a concise, professional
alternative such as "That's all — you're finished with the uninstallation
steps." or "Uninstallation is complete; you can now continue with other tasks."
Ensure tone matches other guides.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@src/content/docs/guides/dns-challenge-cloudflare.mdx`:
- Line 85: Replace the incorrect-cased path string "Runtipi/traefik/traefik.yml"
in the docs text with the correct folder name "runtipi/traefik/traefik.yml" so
it matches the rest of the documentation and works on case-sensitive
filesystems; search for the exact string "Runtipi/traefik/traefik.yml" in
src/content/docs/guides/dns-challenge-cloudflare.mdx and update it to
"runtipi/traefik/traefik.yml".

---

Nitpick comments:
In `@src/content/docs/guides/dns-challenge-cloudflare.mdx`:
- Around line 59-62: Replace the inconsistent phrase "API key" with "API token"
throughout this section so it consistently refers to Cloudflare's API token (not
the Global API Key); specifically update the sentence that begins "Now we need
to get the Cloudflare API key..." to use "API token" and ensure any subsequent
mentions (e.g., "Create token", "save that token") match the same wording and
emphasize that the token is only shown once.

In `@src/content/docs/guides/uninstalling.mdx`:
- Line 15: Replace the informal closing sentence "That's it! Go try something
else out and have fun!" with a more neutral closing; locate the exact string in
src/content/docs/guides/uninstalling.mdx and swap it for a concise, professional
alternative such as "That's all — you're finished with the uninstallation
steps." or "Uninstallation is complete; you can now continue with other tasks."
Ensure tone matches other guides.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: bdae4de1-fdf1-4f5b-95df-5aad8c8b8752

📥 Commits

Reviewing files that changed from the base of the PR and between ed3cf69 and 491c21e.

📒 Files selected for processing (4)
  • src/content/docs/guides/_meta.ts
  • src/content/docs/guides/dns-challenge-cloudflare.mdx
  • src/content/docs/guides/overview.mdx
  • src/content/docs/guides/uninstalling.mdx

Comment thread src/content/docs/guides/dns-challenge-cloudflare.mdx Outdated
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant